Motion.HaltGroup method

Commands a controlled motion stop. The group is moved to the state GroupMoving, until the velocity is zero. When the Done field of KsCommandStatus is true, the state is changed to GroupStandstill.

Namespace: IntervalZero.KINGSTAR.Local.Api

Assembly: IntervalZero.KINGSTAR.Local.Api (in IntervalZero.KINGSTAR.Local.dll) Version: 4.4.0.0

Syntax

C#VB

public KsCommandStatus HaltGroup(
       int Index,
       double Deceleration,
       double Jerk,
       McBufferMode BufferMode
)

Public Function HaltGroup(
       Index As Integer,
       Deceleration As Double,
       Jerk As Double,
       BufferMode As McBufferMode
) As KsCommandStatus

Parameters

Index [in]

Type: int

The index of an axis group. Indexes are zero based. You can have up to 32 groups.

Deceleration [in]

Type: double

A value of the deceleration. The unit is determined by McProfileType. [unit/second²] or [second]

Jerk [in]

Type: double

A value of the jerk. The unit is determined by McProfileType. [unit/second³] or [second]

BufferMode [in]

Type: McBufferMode

Defines how to blend the velocity of two methods.

Return value

Type: KsCommandStatus

Returns the KsCommandStatus class.

Remarks

HaltGroup is used to stop the axis group under normal operation conditions. In non-buffered mode: During deceleration of the axis group it is possible to set another motion command, which will abort the HaltGroup and will be executed immediately.
If this function is active, the next command can be sent. For example, a driverless vehicle detects an obstacle and needs to stop. HaltGroup is sent. Before the Standstill is reached, the obstacle is removed and the motion can be continued by setting another motion command, so the vehicle doesn't stop.
The deceleration is proportional to the velocity of each axis. HaltGroup continues to use the path defined in the previous command. No new path is defined in the HaltGroup function.

Examples

N/A